home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_2 / showansi.zip / SHOWANSI.DOC < prev    next >
Text File  |  1991-12-19  |  6KB  |  163 lines
  1.  
  2.  
  3.  
  4. SHOWANSI V1.0                                              October 1, 1991
  5. -------------
  6.  
  7. As If You Care:
  8. ---------------
  9.  
  10.     SHOWANSI.EXE was written early October 1991 by Matthew E. Desmond, under
  11. the watchful eye of Barry Redwood.  It was written in Turbo Pascal 5.5, and
  12. should work under any hardware/software configuration you can squeeze it into.
  13. This program does NOT do direct screen writes, so you can multitask without
  14. being interrupted by crap generated from them.
  15.  
  16. Legal Stuff:
  17. ------------
  18.  
  19.     This software is free.
  20.     This software is not guaranteed to work.
  21.     This software comes with no warranty (express or implied).
  22.     This software may be distributed in any form, and may be included
  23.         as part of any package.
  24.  
  25. The BeWare concept:
  26. -------------------
  27.  
  28. This software IS (from the verb to BE!).  If you use this software,
  29. you are in no way obligated to do anything much, except use it if
  30. you have it on your disk -- or else its just taking up space.
  31.  
  32. Nonsensical Preamble:
  33. ---------------------
  34.  
  35.     This small package was written on a whim to fill a much needed void!  It
  36. is basically an easy way for users to view ANSI (X3.64) pictures directly from
  37. any Opus 1.7X (or just about any BBS that uses a fossil and can call external
  38. programs...)
  39.  
  40. What does SHOWANSI do?
  41. ----------------------
  42.  
  43.     SWOWANSI will allow your users to view ansi files on line. It was written
  44. to be used with Opus 1.7x and has not been tested on prior versions but there
  45. is really no reason we can see why it will not work although the .OEC files
  46. will may have to be modified for use with earlier versions.  People who do
  47. not use Opus are on their own, but setting this thing up to work should 
  48. be easy.
  49.  
  50. Set-UP for SHOWANSI
  51. -------------------
  52.  
  53.     SHOWANSI.EXE takes either one or two parameters.  The command requires
  54. at least the name of the picture file, and optionally the fossil port number
  55. that you wish to send the picture to.  So, to view a picture locally the
  56. command is:
  57.  
  58.     SHOWANSI filename
  59.  
  60. To send the file to port 1, the command would be:
  61.  
  62.     SHOWANSI 1 filename
  63.  
  64. OPUS BBS.CTL FILE
  65. -----------------
  66.  
  67.     Here is how to set up your OPUS 1.7X BBS.CTL file:
  68.  
  69.     Add this line to the appropriate (MAIN MENU) section of your control file.
  70. The command name may be anything you wish.
  71.  
  72.     _SHOW               Normal       "Ansi-Art" = d:\opus\misc\ansicon#
  73.  
  74.  
  75.     This line will add a new menu option 'Ansi-Art' that will invoke the
  76. ANSICONx.BBS file when selected.
  77.  
  78. The #, <TASK #>, is only required if you are running a multiline system.
  79.  
  80.     You will find sample ANSICON1.OEC and ANSICON1.BBS,  ANSICON2.OEC and
  81. ANSICON2.BBS, files in the SHOWANSI.ZIP file. You may have to modify this
  82. to suit you set-up.
  83.  
  84.     The test BBS has two BBS tasks:  #1 is a local task and #2 is running on
  85. the second fossil port.  The BBS files that call SHOWANSI for task 1 do not
  86. specify a port number, so the picture is displayed locally.  The BBS files
  87. that call SHOWANSI for task 2 specify port 2, and so the picture is sent
  88. to the fossil port 2. 
  89.  
  90.  
  91. Menu .OEC    ANSIMENx.OEC and ANSIMENx.BBS
  92. ---------
  93.  
  94.     We have provided a sample Menu file that you may find useful as a guide.
  95. You will want to configure this menu to correspond the ansi files on your
  96. system.
  97.  
  98.     That is about all there is to it.  The set-up is rather simple, (I hope),
  99. and now it is only a matter of doing all the fill in work.
  100.  
  101.     We have provided a few sample ansi files for you to experiment with:
  102.  
  103.            CITY1.GBS    CITY2.GBS    ROCKET.GBS    MISSILES.GBS
  104.            GOODBYE.GBS  EXIT1.GBS    TRUCK.GBS     RAIDIO.GBS
  105.            ANSICONF.GBS
  106.  
  107.     You may find the batch file included, helpful as well.    It will allow
  108. you to view your ansi screens as you wish to view them. If you were to type
  109. "Z city1" you will be shown  CITY1.GBS and as to press any key to continue,
  110. at which time you will be give a directory of the files  with the extention
  111. .GBS.  If your ansi files have another extention just modify the batch file
  112. to suit the extention used.
  113.  
  114.                       Good Luck and happy VIEWing... 
  115.  
  116.  
  117. GRIPES:
  118. -------
  119.  
  120.     This damn PC keyboard I am using has the CAPS-LOCK key next to the A key
  121. and the CONTROL key down near the space bar.  The rightful place for the
  122. CONTROL key is next to the A key, and CAPS-LOCK is more bother than it is
  123. worth anyway.  Help stamp out this bastardization of your keyboards, write
  124. to your local keyboard manufacturer!
  125.  
  126.     Why do so many people insist on writing programs that use direct screen
  127. writes?  On most '286 systems direct screen writes will bleed through from
  128. the hidden task -- which is really annoying.
  129.     Tip for Turbo Pascal users:
  130.          DO NOT include the crt unit -- since using it guarantees direct
  131. screen writes (and redirection with a > doesn't work well either).
  132.  
  133. ACKNOWLEDGEMENTS:
  134. -----------------
  135.  
  136.     Matthew Desmond for writing the stuff
  137.     Barry Redwood for the idea suggesting bits and pieces and writing the docs
  138.     Matthew Desmond for re-writing Barry's docs a little
  139.     Marion Redwood for making the tea
  140.     Matthew Desmond for drinking the tea
  141.     Geoff Welsh for no particular reason (he'd be upset if he didn't get a
  142.         mention)
  143.     Matthew Desmond for acknowledging Geoff
  144.     City Limits BBS for being a guinea pig
  145.     Matthew Desmond for using City Limits BBS
  146.     Borland for such wonderful toys
  147.     Matthew Desmond for writing the acknowledgements
  148.     Matthew Desmond for reading the acknowledgements
  149.     YOU!!!  for still reading this drivel
  150.  
  151.     P.S.   Who is this Matthew Desmond guy anyway?
  152.  
  153. Stupid Question Dept:
  154. ---------------------
  155.  
  156.     If you have any questions or suggestions, we don't want to hear from you!
  157.     But, if you wish to praise us to high heavens, you may do so:
  158.  
  159. Barry Redwood  or  Matthew Desmond,
  160. City Limits BBS Cambridge, Ontario
  161. 1:221/203           1-519-658-0311.
  162.  
  163.